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Abstract 

The architecture for Spallation Neutron Source accelera- 
tor physics application programs is presented. These high 
level applications involve processing and managing infor- 
mation from the diagnostic instruments, the machine con- 
trol system, models and static databases; they will be used 
to investigate and control beam behavior Primary compo- 
nents include an SNS global database and Java-based Ap- 
plication Toolkit, called XAL. A key element in the SNS 
application programs is time synchronization of data used 
in these applications, due to the short pulse length (1 ms), 
pulsed (60 Hz) nature of the device. The data synchroniza- 
tion progress is also presented. 

1 INTRODUCTION 

The Spallation Neutron Source (SNS) is a high intensity 
pulsed accelerator for neutron production. To commission 
and run the SNS efficiently, high level physics application 
software for modeling, integrated operation and accelerator 
physics studies is required; in particular, construction of an 
object-oriented, accelerator-hierarchy programming frame- 
work. Java is chosen as the core programming language 
because it provides object-oriented scope and existing in- 
terfaces to the controls software (e.g. Java Channel Access) 
and database information (JDBC, XML). The SNS physics 
application software environment includes the SNS global 
database, a Java-based software infrastructure (XAL), and 
existing lattice tools such as Trace-3D and MAD. The core 
part of this environment is the XAL infrastructure, which 
includes links to the SNS database, EPICS Channel Ac- 
cess signals, shared extensible markup language (XML) 
files among applications and external modeling tools, as 
well as built-in accelerator physics algorithms. The present 
plan for quick on-line modeling during the SNS commis- 
sioning is to use Trace-3D for the Linac and MAD for the 
Ring. Data synchronization at the EPICS level for the SNS 
pulsed nature is also in progress, and will be included in 
the XAL infrastructure later 

2 SNS GLOBAL DATABASE 

The SNS global database contains static information about 
beam line devices (magnets, diagnostics, etc.), power sup- 
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plies, magnet measurement, global coordinates, as well as 
other accelerator equipment. The table schemas, entities 
and relationships are described in [|l|]. The basic accelerator 
hierarchy is constructed from the database information. For 
example information for constructing representative beam- 
line sequences, their constituent lattice and diagnostic com- 
ponents, and the mapping of beamline components to their 
respective EPICS Process Variables (PVs) all comes from 
the global database. 

Although it is possible to directly query the database 
from the Java based XAL framework, an intermediate 
XML file containing the accelerator hierarchy is created in- 
stead. The structure of the XML files is based on the XAL 
class view. The global database to local XML file transla- 
tion is a stand-alone program outside the XAL, which ob- 
viates the need for each XAL based applications to query 
the database for initialization. 

3 XAL INFRASTRUCTURE 

The XAL infrastructure is a Java class structure providing a 
programming interface with an accelerator hierarchy view. 
XAL is a variant of UAL 2.0[||], and detailed API informa- 
tion for the XAL can be found on-line [|^. A schematic dia- 
gram depicting the XAL infrastructure relationship to other 
accelerator components is shown in Fig. ^. The XAL pro- 
vides application programs with connections to the static 
data via XML files and the run-time data via Java Channel 
Access. 

The XAL class hierarchy is shown in Fig. |^. At the top 
of the XAL class hierarchy is the SNS accelerator. The ac- 
celerator is composed of different Accelerator sequences, 
e.g. Medium Energy Beam Transport (MEET), Drift Tube 
Linac (DTL), Ring. The sequences are composed of nodes, 
e.g. Quadrupoles, BPMs, Correctors. There is a built-in ca- 
pability to include algorithms in XAL, but initially we are 
using an external model (Trace-3D) for the Linac applica- 
tions. Regarding scripting possibilities, XAL class objects 
directly with Jython are being tested, without the need for 
interface code. 

3.1 EPICS Channel Access 

All the run-time information for the applications will be ob- 
tained through EPICS Channel Access. The XAL provides 
the connectivity to the EPICS Channel Access via the chan- 
nel access (ca) classes as shown in Fig. 0. Because the SNS 
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Figure 1: Application software infrastructure. 



is a pulsed machine, for many applications the data corre- 
lation among pulses is vital. The ca classes provide both 
synchronized and non-synchronized methods for data tak- 
ing. The data synchronization will be described in detail in 
Section 0. 

3.2 Links to External Modeling Tools 

Most of the existing accelerator modeling software pack- 
ages are written in languages other than Java. In order to 
run applications from Java-based XAL, the software pack- 
ages must be compiled as shared libraries, then connected 
to the shared libraries via the Java Native Interface (JNI). 
The file I/O is done through XML parsing provided by 
XAL, for example, storing the calculated result in XML 
files. Thus the information is portable, share-able, and can 
be accessed remotely. The JNI calls also require arranging 
the running threads carefully because programs normally 
tend to execute its own threads before starting the non-Java 
threads. 

4 DATA SYNCHRONIZATION 

Data synchronization is an important feature for a pulsed 
accelerator (1 ms beam pulses at 60 Hz). The SNS Real 
Time Data Link will synchronize the clocks of all lOCs 
across the accelerator at 60 Hz rate, ensuring a good syn- 
chronization of the time-stamps being applied to PVs[^. 
However, it may be difficult for high level applications to 
reliably gather sets of data from across the accelerator, all 
from the same pulse. To facilitate this, a data-silo data time 
correlator is being written. The data-silo method is shown 
schematically in Fig. ^ For a requested PV set, the corre- 
lator returns the most recent collection of time-correlated 
data. 

The behavior of the DataSilo class is configurable by 
three parameters: the maximum time to wait since start of 
request, maximum width of the time bin, and the maxi- 
mum number of channels allowed to be missing from the 



synchronized data set. The correlator is implemented as 
the C++ DataSilo class which allows the application's pro- 
grammer to: 

• add and remove EPICS process variables from the 
DataSilo set; 

• dynamically define the maximum wait time, max- 
imum bin number, and maximum missing bins al- 
lowed; 

• obtain the most recent synchronized set (no waiting); 
wait up to the maximum time to obtain a synchronized 
set (blocking) 

• choose the earliest, latest, or mean time stamp from a 
synchronized set. 

5 CONCLUSION 

The SNS global database is close to the end of design phase 
and has been tested with SNS MEET data. The XAL in- 
frastructure is constructed and tested with a modeling tool, 
Trace-3D. The Channel Access part of the XAL will be 
tested with simulated IOC signals. Scripting tools such as 
Matlab and Python will be used in the MEET commission- 
ing this spring. 
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Figure 2: XAL infrastructure. 
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Figure 3: Data-silo for data synchronization. 
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